home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / masdir42.arc / SDLSETUP.DOC < prev    next >
Encoding:
Text File  |  1989-03-08  |  9.1 KB  |  214 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      * * *
  8.      SDLSETUP.BAT - DOCUMENTATION - Copyright (c) 1987,88 Bob Stephan
  9.      * * *
  10.      You will be able to browse through the SDLSETUP documentation
  11.      at your own pace.  Just use the keys on the cursor pad to turn
  12.      the pages as you read.  Note the reminder at the top of the
  13.      screen, and remember that you can exit at any time by pressing
  14.      Esc.
  15.      * * *
  16.      SDLSETUP will not modify any of your original files.  Only
  17.      SDL.COM will be affected.  In particular, your CONFIG.SYS and
  18.      AUTOEXEC.BAT will not be touched.
  19.  
  20.  
  21.     (Press the PgDn key to continue)
  22.  
  23.  
  24.  
  25. Documentation for SDLSETUP.BAT for SDL Version 4.2, January 1989
  26. Copyright(c) 1987, 1988, 1989 Bob Stephan
  27.  
  28. SDLSETUP is a handy program to customize many of the options of
  29. SDL, my Sorted Directory and disk Label printing program.  It requires
  30. only that you answer a series of questions with single keystroke
  31. responses and, if desired, input new titles to appear in the top 2 lines
  32. of the display.
  33.  
  34. To run SDLSETUP establish a working disk or directory (a RAM disk will
  35. be fastest, a directory on a hard disk next, and a floppy can be
  36. quite slow).  Enter the following command to copy the necessary
  37. files from the MASDIR diskette to your working area.  Assume that the
  38. MASDIR diskette is in drive B: and the working area is the current
  39. directory on drive C:.  Then just enter
  40.  
  41.     COPY B:SDL*.* C:
  42.  
  43. You can add the path after C: if you so desire, or just issue this
  44. command after changing to the working disk or directory.  You can use
  45. MAKEWORK to help you do this if you like.  Enter MAKEWORK at the DOS prompt.
  46.  
  47. All of the questions in SDLSETUP are self-explanatory and should cause
  48. no confusion.  A few of them are explained in a little more detail
  49. here.  If you have any questions, read on, and then if you still have
  50. questions after running SDLSETUP please contact me.
  51. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  52. SDLSETUP
  53. * * *
  54. MESSAGE: Checking system resources. Please wait.
  55.  
  56. At this point SDLSETUP is looking for the DOS DEBUG external
  57. command.  If it is not found you will see the message "Bad command
  58. or file name".  This will be followed by a beep and the following:
  59. * * *
  60. The message "Bad command or file name" that you just saw means
  61. that a system file is not available to SDLSETUP.
  62. This program requires access to the DOS external command file
  63. DEBUG.COM.  It must be in this directory on this disk or in
  64. one of the directories on your path, which is
  65. PATH=              (REM: your current path will be displayed here).
  66. Please correct the problem and run SDLSETUP again.
  67.  
  68. (REM: This will be followed by an exit back to DOS for corrective action.
  69.       But if DEBUG is found, SDLSETUP will check for the presence of other
  70.       files.  Depending on what is found you may see some of the following
  71.       messages.  If you don't see them, then all is well.)
  72.  
  73. (REM: One user reported a problem during this portion of the setup
  74.       program, and it turned out that he was running a RAM resident
  75.       program named DOSEDIT.  This appeared to interfere with the
  76.       redirected input to DEBUG.  The solution was just to boot the
  77.       computer without DOSEDIT temporarily while running SDLSETUP.)
  78.  
  79. Next the presence of required files will be verified. If any needed files
  80. are not present, you will see ...
  81. * * *
  82. The following files must be in this current directory on this disk:
  83. SDL.COM
  84. SDL_ASK.EXE
  85. SDLTITLE.COM
  86. SDLPARMS.BAT
  87. SDLSETUP.BAT
  88. SDLFINIS.BAT
  89. SDLDEBUG.BAT
  90.  
  91. The DOS version will be checked.  If it is found to be
  92.       version 2.x you will see the following message.  Please see
  93.       the note at the end of this DOC file.
  94.  
  95. * * *
  96. If you have any difficulty running SDLSETUP under DOS 2.x,
  97. please see SDLSETUP.DOC.
  98. * * *
  99. Setting the More or Pause default...
  100.  
  101. Pausing refers to both intermediate pauses if the directory is
  102. more than one page (screen), and the pause at the end to allow
  103. you to select a new option.  This is merely personal preference, but
  104. pausing is a good idea, and it allows you to select new options.
  105.  
  106. * * *
  107. Setting the Hdr default...
  108.  
  109. The first two lines of the header contain my copyright notice
  110. and the reminder line, as well as the volume label.  If you use
  111. SDL mostly for directories on the your hard disk drive, you may
  112. have no need for the first two lines as a rule.   This permits 2
  113. more rows of files to be shown on the screen.  The directory
  114. name will still be shown, and you can restore the title lines
  115. for any display with the /H option. Later during SDLSETUP you will be
  116. given the opportunity to change the default titles in these two lines.
  117.  
  118. * * *
  119. Setting the sleeve Insert eject default...
  120.  
  121. A half page saves paper if you print many Inserts.  Then if you
  122. print an even number of inserts your TOF setting will not be changed,
  123. but if you print an odd number your printer will be left at the middle
  124. of a page.  If you prefer to always use a full page for a sleeve Insert,
  125. you can set that here.
  126.  
  127. * * *
  128. Installing your own default title lines...
  129.  
  130. If you answer N you are finished, and SDLSETUP will call DEBUG
  131. to make the changes you have requested.  If you answer Y,
  132. another program, SDLTITLE.COM, will be called to ask you for the
  133. titles you want.  The first line title can be 44 characters long
  134. and the second line can be 79 characters long.  If you want to
  135. change only one, just press ENTER for the other.  Whenever you
  136. just press ENTER, the original title will be used.  If you want
  137. to blank out a title completely, just enter one or more spaces.
  138. If you want to have your own titles on the first two lines you will
  139. have to enter them both even though you may just be changing one of
  140. them from a previous setting.
  141.  
  142. To restore the original titles, simply press ENTER at each prompt.
  143. Setting your own titles or restoring the original titles
  144. eliminates the highlighting of the key characters in the reminder
  145. line and allows all lines of the directory display to be redirected
  146. to a file if desired.
  147.  
  148. After the titles the program will run to completion.  The only problem
  149. that can arise is no access to DEBUG.  In that case you will see the
  150. following message.
  151.  
  152. Bad command or file name
  153. Using the DOS DEBUG command appears to have failed!
  154. You may not have a path to DEBUG.  Please check the
  155. directories on your path for the existence of DEBUG.COM.
  156. If you can establish a path to DEBUG or copy DEBUG.COM
  157. to this working area, you can install the changes you
  158. have made by entering SDLDEBUG.
  159.  
  160. If you see this message, please make DEBUG available from
  161. your version of DOS and run SDLSETUP again.  In fact, if you have
  162. gotten this far you can take a short cut and run SDLDEBUG after you
  163. have made DEBUG available.  That will finish up the changes.
  164.  
  165.  
  166. (CAUTION: Do NOT run SDLDEBUG if there has been any other error
  167. or interruption.  In that case it is safer to start over again,
  168. but see the NOTE below.  SDLDEBUG uses redirection and if the
  169. input file SDLSETUP.TXT has not been completed, it can cause a
  170. hangup that will require a reboot.)
  171.  
  172. If everything completed normally you will see the message...
  173.  
  174. SDL.COM has been modified.
  175. Don't forget to COPY your new version of SDL.COM
  176. to the disk and/or directory with your other DOS
  177. commands and utilities.
  178. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  179. That's all there is to it, so enjoy using SDL with your own configuration.
  180.  
  181. SDLSETUP creates two working files named SDLSETUP.TXT and
  182. SDLTITLE.TXT.  These files will be erased when SDLSETUP is
  183. finished with its work.
  184.  
  185. NOTE:  I have run into an occasional problem running SDLSETUP
  186. under DOS 2.1.  Generally it works fine, and I can detect no
  187. problems under DOS 3 or later, but if you see either of the
  188. messages "EXEC failure" or "File creation error" please let
  189. me know.  You might try increasing the "FILES=" value in your
  190. CONFIG.SYS file and reboot.  A remote possibility is that the
  191. directory is full, so you might try running it on a different
  192. drive or in a different directory.  You can also run CHKDSK to
  193. see if there are any other conditions that might cause the error.
  194.  
  195. This problem is apparently caused by a bug or deficiency in DOS
  196. 2.1, but I have included a work-around for it.  If you see
  197. either of the above messages, AND if SDLSETUP has finished all
  198. of its questions through the ones about changing the titles, then
  199. reboot with Ctrl-Alt-Del and get back to the drive and directory
  200. in which you were running SDLSETUP.  (If you are working on a RAM
  201. disk, copy your work to a permanent disk first.) One or two of the
  202. .TXT files named above should be in that directory (2 if you changed
  203. titles, otherwise only the first one).  If you see SDLSETUP.TXT
  204. you can run SDLDEBUG, the last batch file in the series.  This
  205. should install your changes and clean up after itself.
  206. See the CAUTION above about other types of problems.  I apologize
  207. for any inconvenience, but it is a problem beyond my control.
  208.  
  209. As a last resort, run SDLSETUP on a machine that is running
  210. DOS 3 or later.  Then copy the resulting SDL.COM to your
  211. machine.  Good luck!
  212.  
  213.         Now, if you want to exit, remember to press Esc.
  214.